  

                                  Installation
                                  ============

Host platforms
--------------

        We deliver our products via email or on 3.5" floppy discs (1.44 MB IBM Format)
        On request we can send out 720 kB floppy discs.
        These formats can be read by PC, Mac, Amiga, Atari, Acorn.

        If you received the software via email or downloaded it from an electronic
        network you will received it in compressed format (PKZIPF). You will need
        the latest version of PKUNZIP to decompress the software.

        On the Macintosh do not use the standard UNZIP utility. Instead, use
        the ZIPIT utility which you will find on your network.
        In ZIPIT uncheck the box that says: "By default, smart-strip line feeds
        from text files."

        As a rule of thumb avoid options containing the word "smart".


Selecting an installation method
--------------------------------

The preferred method is remote installation as described under
"Installation from PC or Mac".

If your communications program does not support remote installation
,or if installation fails for other reasons, or if you have downloaded
the software directly to your palmtop, use the method described under
"Stand alone installation".

If stand alone installation is not possible because you do not have
enough disk space available, use the method described under
"Guided manual installation".


Installation from PC or Mac
---------------------------

1. Decompress the software (see above).

2. Connect your Series3 computer to your PC or Mac.
   Activate "Remote link" from the PSIONs system screen.
   Start MCLINK or RCOM on your PC or Macintosh.

3. Set the cursor under the RunOPL-icon (not under the OPL editor!) and
   press TAB. When the file selection screen appears, press TAB again.
   In the first line of the dialog box specify the name of the installation
   directory (where the new software is stored), e.g. REM::C:\CSERVE\DOWNLOAD\
   A file selection list appears.

4. Select the file 3setup.opa (first file). Press ENTER. 
   3setup now takes control. The screen goes blank for a few seconds. Don't panic.
   A file selector box appears.

5. The file selector box shows "Script file".
   Select a script of you choice:   DEUTSCH  German language system
                                    ENGLISH  English language system
   
6. The file transfer starts. If the product was installed before,
   3setup will start a dialog asking you if you want to
     (Continue)     = Overwrite existing version
     (Other drive)  = Install new version on different drive
     (Options only) = Install options you did not install the first time.

7. 3setup asks you about the drives to use:
   System drive:    Where the programs go to. We recommend a Flash SSD.
   Data drive:      Where you keep your data. We recommend internal disk or RAM SSD.
   Permanent drive: Where Morpheus will be installed. Usually internal drive, see below.

8. 3setup will ask you about optional modules. You can decide to install
   them now, or you can leave it for later.

9. 3setup will give instructions on how to proceed after the successful
   transfer.


Stand alone installation
------------------------

1. Unzip and move the unzipped files to the palmtop into a new directory.
   (You don't have to transfer README.TXT and ORDER.TXT).

 or
   Move the ZIP file to the palmtop into a new directory
   and unzip on the palmtop (S3a-Unzip utility required).
   Delete the ZIP file to reclaim disk space.

2. Set the cursor under the RunOPL-icon (not under the OPL editor!).
   Press TAB and navigate to the directory containing the unzipped files.
   A file selection list appears.

3. Continue as above with 4)
   After successful installation you may delete the directory
   that was created in step 1 with all of its files.


Guided manual installation
--------------------------

1. Decompress the software (see above).

2. Connect your Series3 computer to your host computer. Start the host
   communications software and activate "Remote link" from the PSIONs system screen.

3. Copy 3setup.opa into M:\APP\ .
   Copy all IPF files (*.IPF) into the same directory M:\APP\ .
   
   Install 3setup.opa to the system screen (see PSION user manual).

4. Activate 3setup by positioning the highlight under it and pressing ENTER.
   A file selector box appears.

5. The file selector box shows "Script file".
   Select a script of you choice:   DEUTSCH  German language system
                                    ENGLISH  English language system

6. The installation begins. If the product was installed before,
   3setup will start a dialog asking you if you want to
     (Continue)     = Overwrite existing version
     (Other drive)  = Install new version on different drive
     (Options only) = Install options you did not install the first time.

7. 3setup asks you about the drives to use:
   System drive:    Where the programs go to. We recommend a Flash SSD.
   Data drive:      Where you keep your data. We recommend internal disk or RAM SSD.
   Permanent drive: Where Morpheus will be installed. Usually internal drive, see below.

8. 3setup will ask you about optional modules. You can decide to install
   them now, or you can leave it for later.

9. 3setup will ask you to copy files from the installation directory
   on the host computer to a target destination on the PSION.
   
   Initiate the file transfer from your host computer.
   When the file has been transmitted, acknowledge this by pressing
   ENTER on the PSION. 3Setup will continue with the next file to be copied.

101. After all files have been copied, 3setup will give instructions
   on how to proceed after the successful transfer.



Installation on the S3a emulator
--------------------------------
The S3a emulator is PSION freeware that was developed originally
by PSION for inhouse testing. The emulator is available on several
PSION related BBS, CIX, and CompuServe.

The emulator runs on PC only. It is able to run as an S3a with
the original screensize of 480x160 or up to a screen size of 640x480.
The sound capabilities are limited (only a beep and a ring), and there
are a few incompatibilities that can make programs behave different.

All of our programs have been tested on the emulator and run well -
however, some minor hitches may be experienced. If you experience problems
and think it is our software, check if the same problems appear on the
palmtop.

To install a application on the emulator:

1. Transfer the ZIP-file to a empty directory (lets say C:\INSTALL\ )
   and unzip.

2. Start the emulator. Place the cursor under the RunOPL icon and
   press TAB. Navigate to C:\INSTALL\. Select 3setup.opa and press
   ENTER.

3. Continue as above. After successful installation you may delete
   C:\INSTALL\ (or leave it as a backup).

4. Entering the registration number. Use the same procedure as on
   the palmtop (no crosscheck against machine owner on the emulator).

Note: After starting the emulator you have to reinstall all not
   inbuilt applications again to the screen.



Installing several application on one disc
------------------------------------------

Modules stored in \APP\COMMON\ are used by several of our applications.
At the present stage these are the modules:

	ABOUT.OPA     About box and registration
	RSSET.OPA     Printer drivers
	DIALSET.OPA   Tone dialling
	
If you install several applications on the same disc manually, make sure
to install the latest version of these moduls.

If you install on a Flash-SSD you can save some memory by installing
these modules only once.

Automated installation with 3setup will take care of all this. It will
replace a module only if the new module is a newer version number.


When things go wrong
--------------------

If the installation does not run smoothly, do not try to install
manually. The chance is, that if 3setup or the installation control (IPF)
file was corrupted, that other modules are corrupted, too.

Please read the instructions again and repeat installation.

You could also try to use a lower transmission speed between host and PSION.

If the problem should persist, check for data corruption.
Order another floppy disc, or download again.

If the problem still persists, please seek our advice.


Morpheus
--------

If you want access help texts or use alarms you need Morpheus.

Please do not send us questions "What is Morpheus". Instead read this:

One of the tricky things when writing OPL-applications is the HELP-key.
For instance, it is not possible to react to the HELP-key when a menu
or a dialog box is on the screen, which is not very nice, because you
may want help to fill out that dialog box.

That is the reason why we created Morpheus. Morpheus is a independent
application which runs in the background and intercepts the HELP-key.
Morpheus checks which application is in the foreground and will then
display the appropriate help texts.

The other function of Morpheus is to handle alarms (for the products
ProPoc and HyperPoc). It can do this better than the Agenda.

Morpheus is launched automatically by any application that uses Morpheus'
services. Morpheus will stay active as long as a client application is
active or any Morpheus-alarms are scheduled. (The actual shutdown may
be delayed for 1 minute). So, usually you don't have to shutdown
Morpheus manually.

One of the beauties of the system is that Morpheus can serve many masters.
So if you use some of our products simultanously, still only one
copy of Morpheus will be active.

Morpheus is installed on the "permanent drive", usually the internal disk.
The permanent drive should not be removed from the palmtop and cannot
be reformatted unless Morpheus is stopped.

If you must, here is the way:

          Install Morpheu2 to the system screen (see user manual)
          Then KILL Morpheus.
          If Morpheus was running it will respond with a beep and will die.
          Deinstall Morpheus (see user manual).


Deinstallation
--------------

To deinstall the application from you palmtop proceed as follows.

1. First backup your system.

2. Remove the data folder. To locate the data folder,
   position the cursor under the application icon and press TAB.

3. Remove the application specific files and folders from your system:

   such as \APP\ProPoc.opa   (Example for deinstalling ProPoc)
           \APP\PROPOC\
           M:\propoc.*

4. If you do not have other applications from us
   such as: F11, HyperPoc, MusiPoc PicPoc, PocDoc, PocView, ProPoc, RepPoc...
 
   remove the following files and folders from your system:

   \APP\MORPHEU2.OPA
   \APP\MORPHEU2\
   M:ALRM.$$$
   \APP\COMMON\


